String.prototype.padEnd()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2017.
The padEnd()
method of String
values pads this string with a given
string (repeated, if needed) so that the resulting string reaches a given length. The
padding is applied from the end of this string.
Try it
Syntax
padEnd(targetLength)
padEnd(targetLength, padString)
Parameters
targetLength
-
The length of the resulting string once the current
str
has been padded. If the value is less than or equal tostr.length
, the current string will be returned as-is. padString
Optional-
The string to pad the current
str
with. IfpadString
is too long to stay withintargetLength
, it will be truncated: for left-to-right languages the left-most part and for right-to-left languages the right-most will be applied. The default value for this parameter is " " (U+0020
).
Return value
A String
of the specified targetLength
with the
padString
applied at the end of the current
str
.
Examples
Using padEnd
"abc".padEnd(10); // "abc "
"abc".padEnd(10, "foo"); // "abcfoofoof"
"abc".padEnd(6, "123456"); // "abc123"
"abc".padEnd(1); // "abc"
Specifications
Specification |
---|
ECMAScript Language Specification # sec-string.prototype.padend |
Browser compatibility
BCD tables only load in the browser